home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CU Amiga Super CD-ROM 4
/
CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso
/
magazine
/
psion
/
utils
/
funzip12.lzx
/
unzip.txt
< prev
Wrap
Text File
|
1980-01-01
|
16KB
|
555 lines
Unzip v1.2 (Archive: FUNZIP12.ZIP)
==================================
This is a freeware user-friendly shell (front-end)
for the UNZIP.IMG image file from David Palmer.
The UNZIP.IMG file can be found on CompuServe in
the Palmtop forum library 18 in different versions
(see the Installation section below)
As with any freeware, I disclaim any liability
whatsoever for problems created by this program.
Although it works fine on my Psion 3a computers,
I do not guarantee that this program is error
free and I will not be held responsible for any
damage or loss of any kind whatsoever.
*** USE AT YOUR OWN RISK ***
That said, I believe I have found all bugs and that
Unzip is stable and reliable.
I wrote this application as I could never remember
the command line options I needed to unzip files.
As David had kindly added full OPL launch support
from version 1.4 of his UNZIP.IMG, I was inspired
to create this very useful shell for David's unzip
utility.
Unzip can be used as a replacement for, or a
supplement to David Palmer's RUN.APP.
New Features in This Version (v1.2)
===================================
* UNZIP.IMG v1.50 support only
* Nice new icon
* Directories used are remembered
* Online-help
* Create file list action
* Selectable file types
* Easier dialog
* Uses much less run-time memory
* Variant added for original series 3 users
See the change history at then end of this file
for exact change details.
Archive Contents
================
When you unzipped this file you should have
found:
File Size Time Date
UNZIP.TXT 16341 01:20 21-Jun-96 (this file)
UNZIP.OPA 2937 01:20 21-Jun-96 (series 3a app)
UNZIP.HLP 1689 01:20 21-Jun-96 (help file)
UNZIP.CLS 2393 01:20 21-Jun-96 (series 3 app)
Installation
============
NOTE: If you have a series 3 (not a 3a) then
please read the Variants of UNZIP.OPA section
towards the end of this file before proceding
any further.
1. Make sure you have v1.50 of the UNZIP.IMG file.
UNZIP.IMG is part of the complete unzip package
from David Palmer, which is available as...
Archive UNZIP.IMG Version
S3UZ150L.ZIP v1.50l (preferred)
S3UZ150S.ZIP v1.50s
S3UNZIP.ZIP v1.50l & v1.50s
File Version
UNZIP.IMG v1.50l
...in the CompuServe Palmtop forum's library 18.
You can also get UNZIP.IMG v1.50 by anonymous
ftp from
ftp://sunsite.doc.ic.ac.uk/computing/systems/
handhelds/psion/icdoc/utils/s3uzip15s.zip or
s3uzip15l.zip
For a detailed explanation of the difference
between v1.50l and v1.50s, see the section
"Variants of UNZIP.IMG" later on in this file.
2. Series 3 users only:
Delete the supplied UNZIP.OPA (it is not
required) and rename the file UNZIP.CLS
to UNZIP.OPA
3. Copy UNZIP.OPA into the *same* directory as
UNZIP.IMG
To retain compatibility with RUN.APP, use a
\RUN\ directory.
If you do not have RUN.APP installed (or wish
to remove it) then I recommend to copy the
files including UNZIP.IMG to an \APP\UNZIP\
directory.
NOTE: UNZIP.OPA will not work unless it is in
the same directory and on the same disk as
UNZIP.IMG.
The file *must* be named UNZIP.OPA
4. Series 3a users only:
If you wish to access online help for UNZIP.OPA,
then copy UNZIP.HLP into the same directory as
UNZIP.OPA.
Online help is optional: if you already know
how to unzip and wish to save memory space,
you may omit the help file.
5. Install the UNZIP.OPA application from the
system screen by using Psion-I, pressing Tab,
and navigating to the directory where Unzip is
located.
NOTE: all you need to unzip is UNZIP.IMG and
UNZIP.OPA. For the optional online help you
also need UNZIP.HLP. All other files in David
Palmer's archive can be deleted from the Psion
if you need to save precious memory space.
Operation
=========
Unzip contains a simple dialog for selecting the
usual unzip options.
All options provided by UNZIP.IMG v1.50 are
supported by the Unzip shell.
When you start Unzip (the same way as you would
start any other application) you will see a dialog
that will look like this...
Unzip v1.2 [Esc] to exit
Unzip from file: Name <file>
Disk Internal
Unzip to directory: Name \
Disk Internal
Action: Extract files
File types: All (*.*)
Overwrite: Prompt
Options: None
NOTE: The example shows the series 3a variant, the
series 3 variant looks slightly different.
If you get any error messages on startup, see the
section "Solving Problems" later on in this file.
If you have UNZIP.IMG v1.50s then the dialog title
will also show "(for PKZIP v2.x only)" indicating
that only archives created with PKZIP version 2.0
and later can be unzipped (see "Variants of
UNZIP.IMG" later on in this file).
Pressing [Esc] from the dialog will exit Unzip and
save the last used directories to an UNZIP.INI
file. The UNZIP.INI file will be created on your
default disk if it does not already exist.
Press [Help] from the dialog to access the optional
online Help. If you did not install the UNZIP.HLP
file, then the author information will be displayed
instead.
Unzip's Dialog
==============
Unzip from file
---------------
Unzip displays files initially in the \ (root)
directory on your default disk.
Press [Tab] to bring up the file selector to
select any file you wish.
You can also access remote drives on your PC using
either PsiWin or RCom - see the section "Accessing
Remote Drives with Unzip" later on in this file.
When Unzip exits, it saves the last used directory
in the UNZIP.INI file.
Unzip to directory
------------------
Unzip will initially unzip to \ on your default
disk.
Press [Tab] for the file selector to select any
other directory.
You can also unzip to remote drives on your PC
using either PsiWin or RCom - see the section
"Accessing Remote Drives with Unzip" later on in
this file.
When Unzip exits, it saves the last used directory
in the UNZIP.INI file.
Action
------
Extract files (default)
This will extract all the zipped files in the
archive.
Update existing & create new
This will unzip files only if the zipped files
have a timestamp which is newer than the
existing files in the destination directory
(existing files will be overwritten), and it will
also create any new files that do not exist.
This is a good choice if you want to unzip an
archive directly to a flash SSD. Unchanged files
will *not* be overwritten, thus saving precious
flash SSD space.
Freshen (update existing only)
This does the same as above except that *no* new
files are created.
This is the best choice if you wish to update an
existing program but you do *not* want to unzip
files that you do not have installed (eg: text
files and optional files).
A good choice when unzipping a newer program
version directly to a flash SSD.
NOTE: UNZIP.IMG complains if you choose this
action together with the overwrite option "Never".
Test archive integrity
Test to see if the archive's files are not
corrupted and if they can be unzipped OK by
UNZIP.IMG .
Display archive comment
Does just that.
NOTE: many archives do not use the comment
feature however FUNZIP12.ZIP does!
List files (short)
Displays all the files in the archive showing
just size, date, time and name.
List files (long)
This does the same as the short list but displays
a bit more information about each file.
Create file list (short)
Creates a "\WRD\Filelist.wrd" file on your
default disk containing the short file list.
The file list is overwritten each time.
This is very useful to see what files are in the
archive, and as the file list is viewed in Word,
gives a better display (especially when the
archive contains many files) then the "List files"
above. You can also print the file list from Word.
Create file list (long)
The same as above but with more information
about each file.
File types
----------
All (*.*), Readme (readme.*), Text (*.txt),
Text (*.doc), Word (*.wrd), Agenda (*.agn),
Data (*.dbf), Sound (*.wve), Sheet (*.spr),
World (*.wld), Executable (*.app),
Executable (*.opa), Executable (*.opo)
You can select which files you wish to extract.
This is handy if you just wish to extract just
some files first (and maybe read them) before
extracting the rest of the files.
Only files that match the selected file type will
be extracted.
A match is made when:
* the archived filename is stored in all lower
or upper case (ie: readme.* or README.*)
* the first letter of the matching text is upper
case and the rest is lower case
(ie: Readme.*, *.Txt, *,Dbf, etc.)
You can check how the archived filenames are
stored by creating a file list.
Overwrite
---------
NOTE: overwrite options do not apply to the
"Create file list" action.
Prompt
Unzip will ask you what to do if it finds an
existing file when extracting.
Never
Unzip will *never* overwrite any existing files.
NOTE: UNZIP.IMG complains if you choose
overwrite together with "Action: Freshen (update
existing only)"
Always
Unzip will *always* overwrite existing files.
Options
-------
None
No options.
Discard paths
If the archive contains paths, normally they are
extracted and created when unzipping.
Choosing this option will *prevent* the paths
from being created, and all files will be
unzipped to the same directory.
Quiet operation
Prevents some text from being displayed on the
screen or saved to the file list.
Very quiet operation
Even quieter than quiet operation.
Illegal Combinations
====================
UNZIP.IMG will complain if you select both
"Action: Freshen (update existing only)" AND
"Overwrite: Never"
Variants of UNZIP.OPA
=====================
The Unzip shell is enclosed in this archive
in two variants:
UNZIP.OPA (2937 bytes)
Series 3a variant (v1.2)
For the series 3a only, will not run on the
series 3. Full utilisation of series 3a
display size and help system.
UNZIP.CLS (2401 bytes)
Series 3 classic variant (v1.2c)
Pruned-down variant for the series 3. Will
run on the series 3a as well, but 3a users are
encouraged to install the 3a variant.
The classic variant is slightly different to
the series 3a variant:
* No help system possible (so do not
install UNZIP.HLP)
* Main dialog split into two sections and
some dialog text shortened due to display
space limitations
If you need to install the series 3 classic
variant, then rename the file UNZIP.CLS
to UNZIP.OPA and install as shown above in
the installation section.
All of the unzip features are supported in
the series 3 classic variant.
Variants of UNZIP.IMG
=====================
UNZIP.IMG v1.50 comes in two variants:
v1.50l (large variant, 42160 bytes, *preferred*)
Can extract files compressed with both PKZIP v1.x
and PKZIP v2.x
Install this variant if you have the space
available (highly recommended)
v1.50s (small variant, 32816 bytes)
Can only extract files compressed with PKZIP
v2.x. Attempting to extract files compressed
with PKZIP v1.x will produce "unknown compression
method" errors.
Unzip knows if you have v1.50s by displaying the
text "(for PKZIP v2.x only) in the dialog title.
Install this variant if you are short on memory
space and do not need to unzip PKZIP 1.x archives.
UNZIP.IMG Compatibility
=======================
This version of Unzip has been designed to work
purely with v1.50s and v1.50l of UNZIP.IMG
I have tested UNZIP.OPA with both versions of
UNZIP.IMG...
Version Size Time Date
v1.50l 42160 01:50 13-Jun-96
v1.50s 32816 01:50 13-Jun-96
s = small, for PKZIP 2.x only
l = large, for PKZIP 1.x and 2.x
...and both work happily.
Older versions of UNZIP.OPA provide support for
older UNZIP.IMG image files, see the change
history below.
Solving Problems
================
Error messages that show "Unzip" on the top of the
screen and the Unzip icon are from the Unzip shell.
Common error messages are:
"Unzip.img not found"
at startup means that the file UNZIP.IMG is not in
the same directory on the same disk as UNZIP.OPA.
Reinstall UNZIP.IMG v1.50 to the same place
as UNZIP.OPA
"Wrong Unzip.img"
at startup means that your UNZIP.IMG file is not
version v1.50.
Install UNZIP.IMG v1.50
"Error in UNZIP\M Invalid name" or
"Error in UNZIP\M End of file"
at startup means that the UNZIP.INI file is
corrupt.
Delete UNZIP.INI (it is on your default disk)
The INI file will be recreated automatically.
"Error in UNZIP\M Write protected"
after pressing [Enter] to continue from the
dialog means that the UNZIP.INI file cannot be
written as the default disk is write protected.
Change the default disk from the system screen.
"Error in UNZIP\M File or device in use"
after pressing [Enter] to continue from the
dialog means that the UNZIP.INI file cannot be
written as it is being used by another program
(maybe you are viewing it with Word?)
Find the program using UNZIP.INI and exit it.
Error messages that occur when "UnZip v5 for
EPOC (version 1.50x)" is displayed are from the
UNZIP.IMG file.
Common error messages are:
"can't allocate the work area"
There is not enough free memory for the
UNZIP.IMG file to run.
Close other applications and delete unnecessary
files to free up some disk memory.
UNZIP.IMG needs about 100k free memory to run.
"Cannot create [file]: write error or (disk full?)"
UNZIP.IMG could not unzip any more files as the
disk is most probably full.
Close other applications and delete unnecessary
files to free up some disk memory.
"End-of-central-directory signature not found"
The file you are trying to unzip is not a PKZIP
compatible archive.
Choose the correct file.
"error: invalid response [x]"
UNZIP.IMG was asking you to press a certain key
and you pressed key [x] instead.
Press a correct key.
"unknown compression method"
Archive was probably created with PKZIP v1.x
and you are using UNZIP.IMG v1.50s.
Install v1.50 variant l.
Accessing Remote Drives with Unzip
==================================
Accessing remote drives is possible with
either PsiWin or RCom. MCLink has not been
tested.
Remote drives will always appear in the file
selector prefixed with "REM::"
NOTE: The default setting of PsiWin will not
allow remote access of PC files from the
Psion.
You can change this by editing the
PSIONPRC.INI file in the Windows directory,
and removing the '-x' from the end of the
line "engine=prcenwin.exe -x"
Acknowledgements
================
Full and grateful acknowledgements go to David
Palmer of Edinburgh, Scotland, for his wonderful
UNZIP.IMG and his excellent documentation.
Change History
==============
21-Jun-96 v1.2
Created series 3 classic variant (v1.2c).
Reduced runtime memory requirements by 47%.
File selector now shows all files (* instead
of *.zip).
Removed support for earlier versions of
UNZIP.IMG to force the user to upgrade to
v1.50 (s or l) and to reduce code size.
Added better error handling when trying to
find or detect the UNZIP.IMG file.
Changed the icon.
Unzip now remembers last directories used
in UNZIP.INI.
Added (optional) online help.
Added ability to extract certain "File types".
Added "Create file list" action.
Rearranged the dialog layout and changed some
dialog text.
07-May-96 v1.1
Added support for UNZIP.IMG v1.0/1.2/1.3.
Renamed a couple of options and fixed a spelling
mistake.
Optimised code to make the .OPA as small as
possible.
01-May-96 v1.0
Original version (only for UNZIP.IMG v1.41).
-------------------
Jochen Siegenthaler
Zurich, Switzerland
21 June, 1996
100127.3167@compuserve.com